home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / flpro441.zip / FLPRO.DOC < prev    next >
Text File  |  1992-05-30  |  33KB  |  799 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.            ┌───────┐   ┌──┐       ┌──────┐    ┌──────┐      ┌────┐
  13.            │  ┌────┘█  │  │█      │   ┌┐ └┐   │   ┌┐ └┐    ┌┘ ┌┐ └┐
  14.            │  └───┐▀▀  │  │█      │   └┘ ┌┘█  │   └┘ ┌┘    │  ││  │█
  15.            │  ┌───┘█   │  │█      │  ┌───┘█▀  │  ┌┐  └┐    │  ││  │█
  16.            │  │█▀▀▀▀   │  └───┐   │  │█▀▀▀    │  │└┐  └┐   └┐ └┘ ┌┘█
  17.            └──┘█       └──────┘█  └──┘█       └──┘█└───┘█   └────┘█▀
  18.             ▀▀▀▀        ▀▀▀▀▀▀▀▀   ▀▀▀▀        ▀▀▀▀ ▀▀▀▀▀    ▀▀▀▀▀▀
  19.  
  20.                      FileList Pro Version 4.40α release 19
  21.  
  22.                              Designed and Compiled
  23.                                        by
  24.  
  25.                                    Wang Yumin
  26.  
  27.                   Copyright (C) 1990-92. All Rights Reserved.
  28.  
  29.                              User Operation Manual
  30.  
  31.  
  32.      ■ Product of Singapore ■ Produce de Singapour ■ Xin Jia Po Zhì Zhào ■
  33.  
  34.  
  35.  
  36.                                    IMPORTANT!
  37.  
  38. The software is provided as "it is". Responsibilities and risk in using this
  39. program or its parts, are take completely by the person using it. No warranty
  40. comes with this software. Please you disagree with the above, please do not
  41. touch/use the program.
  42.  
  43. FLPRO may be circulated freely provided that it MUST be re-distributed in its
  44. most original form. NO files may be modified nor they can be removed. No extra
  45. fee should be charged. Cost of diskette may be charged at a minimum amount of
  46. S$5. It may not be included in Commercial Software Libraries. FLPRO is released
  47. under the Shareware concept. Read section on registeration for details.
  48.  
  49. FLPRO and FileList Pro refers to all executable files and documentations.
  50.  
  51.  
  52.  
  53.                                   Introduction
  54.  
  55.     FileList Pro was started in 1990 to kill time (really!). I was rather bored
  56. and tried to attempt new things until i came to FLPRO idea. The first version
  57. was 2.3.1 which wasn't a good one. Tons of bugs are loaded, although it does
  58. work and i was using it myself. Speed was also a problem, FLPRO 3.2.1 was slow.
  59. Then there was a version 3.2 in early 1991 (if my memory is good). It was
  60. released as freeware! But still, that was not my ideal software. Modifications
  61. were made until one day when my harddisk crashed (no FLPRO backup). I rewrote
  62. the whole thing and came version 4.0 (unreleased) to be beta tested by my beta
  63. testers. Followed was 4.01, 4.02 then 4.03 - the released beta testing version.
  64. Now, version 4.30 is released mainly as a major-bug-fix version with some new
  65. features. Version 4.31 is just a minor bug fix release 2 days after 4.30.
  66.  
  67.     It now supports both Remote Access 1.XX (FILES.RA) and Fido v12 (AREAS.INI)
  68. and all other FILES.BBS systems (eq. SBBS, Maximus, QBBS, Opus, OPENLink etc.)
  69. Doing many things that you found in your dreams and now in reality.
  70.  
  71.  
  72.  
  73.  
  74.                                 C o n t e n t s
  75.  
  76.                                    Disclaimer
  77.                                   Introduction
  78.                                   Content Page
  79.                                   Requirements
  80.                               Beta Tested Systems
  81.                                   How to Use -
  82.                   list of commandline parameters and examples,
  83.                             list of default settings
  84.                         Simple AREAS.INI file structure
  85.                          Header control file structure
  86.                               All file list sample
  87.                                  Registeration
  88.                      Support, Registeration and Test Sites
  89.                                  Miscellaneous
  90.  
  91.  
  92.  
  93.  
  94.                                   Requirements
  95.  
  96.    o IBM PC/8088/8086/80286/80386/80486 or other compatible systems.
  97.    o Preferbly 640 Kilobytes of total conventional RAM.
  98.    o Aprox. minimum 100 kilobytes of diskspace.
  99.    o 80x87/80486 maths co-processor (optional)
  100.      Turn ON your co-processor if you have one. It makes FLPRO runs faster.
  101.      The presence of it is auto-detected.
  102.  
  103.    NOTE: If you are a DesQView user, please turn ON the "Use math coprocessor"
  104.          option as this program has been tested to work under DV only when that
  105.          option is on.
  106.  
  107.    o MS DOS 3.3 and above or compatible OS.
  108.    o Remote Access version 1.XX or FILES.RA and FILES.BBS compatible system.
  109.      or Fido version 12 or AREAS.INI and FILES.BBS compatible system.
  110.  
  111.                               Beta Tested Systems
  112.  
  113. #1 - RA 1.10                                 #4 - RA 1.01
  114.      IBM 80486/33                                 IBM 80286/16
  115.      MS DOS 5.0                                   MS DOS 5.0
  116.      SHARE loaded                                 No multi-tasker loaded.
  117.      DesQView 2.34                                580kb conventional RAM free.
  118.      Qemm 386 5.13
  119.      530kb conventional RAM Free
  120.  
  121. #2 - RA 1.11                                 #5 - RA 1.11
  122.      IBM 80486/33                                 IBM 8088
  123.      MS DOS 5.0                                   MS DOS 4.01
  124.      SHARE loaded                                 No multi-tasker loaded.
  125.      DesQView 2.40                                580kb conventional RAM free.
  126.      Qemm 386 6.00
  127.      500kb conventional RAM Free
  128.  
  129. #3 - Fido 12u                                #6 - RA 1.11
  130.      IBM 80486/33                                 IBM 80386/33
  131.      MS DOS 5.0                                   MS DOS 5.00
  132.      SHARE loaded.                                No multi-tasker loaded.
  133.      No multi-tasker loaded.                      575kb conventional RAM free.
  134.      Qemm 386 6.00
  135.      550kb conventional RAM free.
  136.  
  137.  
  138.  
  139.                                    How to Use
  140.  
  141. FLPRO should be quite easy to setup as there are no configuration files are
  142. needed.
  143.  
  144. Usage:
  145.        FLPRO [+fido] [+fast] /[actions] /[options]
  146.  
  147. To tell FLPRO that you are using Fido v12's AREAS.INI, you will have to add
  148. +FIDO in your commandline when running FLPRO. For RemoteAccess systems, you
  149. need not specify a particular parameter for it. FLPRO assumes that you are
  150. using a RA1.10 system by default.
  151.  
  152. By using the +FAST parameter, the introduction (FLPRO) screen will be skipped.
  153. Useful if you wish to save time running the program. Anyway, the intro screen
  154. is only there for decorations. Looks better? :-)
  155.  
  156. * Global Options * (Can be used by both Fido12 and RA 1.1 users)
  157.  
  158. Actions:
  159.  
  160. /A[filespec]      Generate all files list. [filespec] is the filename to list
  161.                   the files. default filename is ALLFILES.LST. [filespec] is
  162.                   optional.
  163.                   eq. /AFILES.TXT
  164.  
  165. /F[filespec]      Adopt unlisted files. If a file is present in your directory
  166.                   but not listed in Files.Bbs, using this function will append
  167.                   the filename to Files.Bbs. [filespec] is optional which is
  168.                   the file-adopt control file. The control file contains all
  169.                   the filenames that you do not want to be adopted into
  170.                   Files.Bbs. If not control filename is specified,  FLPRO will
  171.                   adopt all files. PS: control may only contain up to 5,000
  172.                   filenames.
  173.                   eq. /FADOPT.CTL or just /F
  174.  
  175. /C                Arrange Download Counters. In this version, only [##]
  176.                   counters are being used. Others like (##), <##> etc. will not
  177.                   be recognised. By using this option, if a counter is not
  178.                   present on any listed files, FLPRO will add [ 0] to it.
  179.                   If you have things like [4], FLPRO will change it to [ 4] and
  180.                   so on.
  181.  
  182.                   example -
  183.  
  184.                   old files.bbs:
  185.                   FLPRO38B.ZIP RA1.00 Filebase enhancement v3.8b
  186.  
  187.                   new files.bbs:
  188.                   FLPRO38B.ZIP [ 0] RA1.00 Filebase enhancement v3.8b
  189.  
  190. /Z                Remove all download counters from FILES.BBS
  191.                   Sometimes you may like to reset all the counters to zero,
  192.                   you can use this option which will remove all [##] from the
  193.                   files list. To place back [ 0], you can use option /C again.
  194.  
  195. PS: You shouldn't use both /C and /Z at a time. But FLPRO will exit itself when
  196.     you do this.
  197.  
  198. /H[filespec]      Add header to Files.Bbs; after reading through each directory
  199.                   FLPRO will add a header which contain the summary of the
  200.                   files in that directory - size, number of files etc.
  201.                   [filespec] is the header control which contains your own
  202.                   structure of header if you wish to design it yourself. Read
  203.                   section on header control file for furthur details.
  204.  
  205. default example -
  206.  
  207.  FileList Pro v4.03ß+
  208.  ┌─────────────────────────────────────────────────────────────────────────┐
  209.  │ #50  - International Programmers Exchange         Updated on 11-27-1991 │
  210.  │ Online files : 26   (1737 KB)               Offline files : 0    (0 KB) │
  211.  ═══════════════════════════════════════════════════════════════════════════
  212.  
  213.                   P.S. The first and last last line of the header must not be
  214.                        altered as they tells FLPRO where to start and where to
  215.                        end.
  216.  
  217. /X[filespec]      Clear up wanted strings in file descriptions. [filespec] must
  218.                   be given or else it won't run as [filespec] contains the
  219.                   unwanted strings. FLPRO won't know what you don't want if
  220.                   there are no control file. This is useful when your users
  221.                   often enter vulgar descriptions, ANSI codes or anything you
  222.                   dislike. All unwanted strings will be replaced with "X"s.
  223.  
  224. /S[filespec]      Generate filebase statistics file. This function will tell
  225.                   FLPRO to read through the directories and create a summary of
  226.                   your filebase's statistics. The number of online/missing
  227.                   files and size will be included. The total will also be
  228.                   calculated.
  229.  
  230. example -
  231.  
  232. ■ Directories Statistics                            27 Nov 91 ■
  233.  
  234. Area Name                                         Online   Offline  Size
  235. ───────────────────────────────────────────────────────────────────────────
  236. User Recent Uploads                               26       0        17370
  237. Data Communications                               40       8        9898
  238. Computer Sound and Music                          127      7        7550 
  239. Singapore BBS List Weekly                         28       0        597
  240. DM LiNKS NETwork Documents                        15       0        81
  241. .                                                 .        .        .
  242. .                                                 .        .        .
  243. .                                                 .        .        .
  244. ───────────────────────────────────────────────────────────────────────────
  245. Total                                             1049     97       52829 
  246.  
  247.  
  248.  
  249. /P[filespec]      Generate popular downloaded files. This function WILL ONLY
  250.                   WORK if you have download counters in your files.bbs! FLPRO
  251.                   analyses the most popular file with the download counters
  252.                   which indicates the number of times that file has been
  253.                   downloaded. PS up to 10,000 files only.
  254.  
  255. example -
  256.  
  257. Popular Downloads                    27 Nov 91
  258.  
  259. Filename      D/L   Descriptions
  260. ───────────────────────────────────────────────────────────────────────────
  261. 600-210.ZIP   [89] All files list for 6:600/210
  262. DSLJ2691.ZIP  [46] Singapore BBS Listing 26 Oct 91 -Ls
  263. NEW210.ZIP    [44] This BBS' registeration info
  264. FLPRO403.ZIP  [42] FileList Pro v4.03beta for RA 1.10, Fido 12
  265. DSLJ1991.ZIP  [36] Singapore BBS Listing 19 Oct 91 -Ls
  266. DSLK0291.ZIP  [33] Singapore BBS Listing 2 Nov 91 -Ls
  267. DSLK2391.ZIP  [31] Singapore BBS List Weekly 23 Nov 91 -Ls
  268. DSLK1691.ZIP  [28] Singapore BBS Listing 16 Nov 91 -Ls
  269. DSLH1091.ZIP  [24] Singapore BBS Listing 10 August 91 -Ls
  270. DSLH2491.ZIP  [22] Singapore BBS Listing 24 August 91 -Ls
  271.  
  272.  
  273. /V[x]             Convert FILES.RA to Flsearch.Ctl or Areas.ini. Obviously, you
  274.                   must have a RA 1.XX Files.Ra to make it work. x can be 1 or 2
  275.                   where :
  276.  
  277.                           1 - Flsearch.Ctl (QBBS)
  278.                           2 - Areas.ini    (Fido 12)
  279.  
  280.                   if x is not supplied, 1 is set to default. This option is
  281.                   most useful when you are using Fido or QBBS utilities which
  282.                   requires to have these files. Certain Fido utilities requires
  283.                   a compiled Areas.Ini (Fido.Sys) generated by SET-FIDO.EXE, it
  284.                   is available in all Fido BBS releases.
  285.  
  286. /R|n|m|r          Sort Files.Bbs in alphabetical order.
  287.                   (up to 5,000 files per file area only)
  288.  
  289.             /R or /Rn is to sort in the normal way. Aware of remarks (lines
  290.                       beginning with a space, dash or empty line, ignore all
  291.                       remarks and only sort filenames.
  292.                   /Rm is to sort with multi-line-descriptions-aware method.
  293.                       All lines beginning with 20 spaces or more will be
  294.                       classified as a multi-line-description. They will be
  295.                       treated as part of the filename before it. Filenames
  296.                       are sort normally.
  297.                   /Rr Raw sorting. FLPRO will sort just like DOS' SORT.EXE
  298.                       and ignore all whatever remarks etc. The whole files.bbs
  299.                       will be sorted altogether. Note that this option will
  300.                       mix all the remarks and filenames together.
  301.  
  302.                                     Examples
  303.  
  304. PS: Examples are listed as files.bbs structure. Lines beginning with 20 spaces
  305.     are susposed to be multi-line descriptions.
  306.  
  307. Before any sort:
  308.  
  309. - Area #10 - Ridiculous files directory
  310. FILE2.ZIP    [00] More about files.
  311.                               Advance knowledge on files.
  312.                               Why must we have files?
  313. FILE1.ZIP    [00] File all about files
  314.                               Tells you everything you want
  315.                               to know about files.
  316.  
  317. After /Rm sort:
  318.  
  319. - Area #10 - Ridiculous files directory
  320. FILE1.ZIP    [00] File all about files
  321.                               Tells you everything you want
  322.                               to know about files.
  323. FILE2.ZIP    [00] More about files.
  324.                               Advance knowledge on files.
  325.                               Why must we have files?
  326. (Note that the long-spaced remarks are assumed to be multi-line descriptions)
  327.  
  328. After /R or /Rn sort:
  329.  
  330. - Area #10 - Ridiculous files directory
  331. FILE2.ZIP    [00] More about files.
  332.                               Advance knowledge on files.
  333.                               Why must we have files?
  334. FILE1.ZIP    [00] File all about files
  335.                               Tells you everything you want
  336.                               to know about files.
  337. (Note that the multi-descriptions are ignored and treated as normal remarks,
  338.  they are ignored)
  339.  
  340.      ------------------------------------------------------------------
  341. After /Rr or DOS' SORT.EXE process:
  342.  
  343. FILE1.ZIP    [00] File all about files
  344. FILE2.ZIP    [00] More about files.
  345. - Area #10 - Ridiculous files directory
  346.                               Advance knowledge on files.
  347.                               Tells you everything you want
  348.                               to know about files.
  349.                               Why must we have files?
  350.  
  351. (Note that raw sort and other sorters are not aware of files.bbs remarks or
  352.  multi-line descriptions)
  353.  
  354.  
  355. Before any sort:
  356.  
  357. FILETXT2.ZIP [00] Text on Files #2
  358. DEF.ZIP      [00] List of other 13 alphabets!
  359. FILETXT1.ZIP [00] Text on Files #1
  360. HACKRA.ZIP   [00] Register your own RA copy!
  361. ABC.ZIP      [00] List of all 13 alphabets!
  362.  
  363. - Other programs
  364. HACKQBBS.ZIP [ 0] Register your own QBBS copy!
  365. HACKZMSG.ZIP [ 0] Register your own ZMAIL copy!
  366. MODEMF.ZIP   [ 0] Free modems to give AWAY!
  367.  
  368. After /Rm or /Rn sort:
  369.  
  370. ABC.ZIP      [00] List of all 13 alphabets!
  371. DEF.ZIP      [00] List of other 13 alphabets!
  372. FILETXT1.ZIP [00] Text on Files #1
  373. FILETXT2.ZIP [00] Text on Files #2
  374. HACKRA.ZIP   [00] Register your own RA copy!
  375.  
  376. - Other programs
  377. HACKQBBS.ZIP [ 0] Register your own QBBS copy!
  378. HACKZMSG.ZIP [ 0] Register your own ZMAIL copy!
  379. MODEMF.ZIP   [ 0] Free modems to give AWAY!
  380.  
  381. (Note that both multi-line and normal sort produce the same result for
  382.  this kind of files.bbs structure where no multi-line descriptions exist)
  383.  
  384.      ------------------------------------------------------------------
  385. After /Rr or DOS's SORT.EXE process:
  386.  
  387. - Other programs
  388. ABC.ZIP      [00] List of all 13 alphabets!
  389. DEF.ZIP      [00] List of other 13 alphabets!
  390. FILETXT1.ZIP [00] Text on Files #1
  391. FILETXT2.ZIP [00] Text on Files #2
  392. HACKQBBS.ZIP [ 0] Register your own QBBS copy!
  393. HACKRA.ZIP   [00] Register your own RA copy!
  394. HACKZMSG.ZIP [ 0] Register your own ZMAIL copy!
  395. MODEMF.ZIP   [ 0] Free 19.2kbps modems to give AWAY!
  396.  
  397. /Rr command only comes useful when you wish to merge two groups of files
  398. in files.bbs (you may have grouped the files in one files.bbs with spaces).
  399.  
  400.  
  401.  
  402. /L                License Info. Whether your copy is registered. If not,
  403.                   what should you do.
  404.  
  405. Options:
  406.  
  407. /B[x]             Begin process at filearea x. If x is 2, FLPRO will start with
  408.                   file area #2 and ignore all areas before it.
  409.                   eq. /B10
  410.  
  411. /E[x]             Ends process at filearea x. If x is 5, FLPRO will stop
  412.                   process at file area #5 and ignore all areas after it.
  413.                   eq. /E5
  414.  
  415. /O[x]             Process only area x. If x is 1, only file area #1 will be
  416.                   processed. All others are ignore.
  417.                   eq. /O1
  418.  
  419. /$[x1,x2,..]      Exclude areas #x1, #x2 and so on up to 20 areas possible.
  420.                   eq. /$1,5,12,31 to exclude areas 1, 5, 12 and 31.
  421.  
  422. PS: If /B, /E and /O are not specified, all areas will be processed by default
  423.  
  424. /N[x]             Number of days to be considered as new files. List ONLY
  425.                   new files in all files list. By using this options, your
  426.  
  427.  
  428.                   all files list will only contain files that are dated within
  429.                   x days from present date.
  430.                   eq. /N5
  431.  
  432. /D                Do not include remarks in All files list. Meaning all the
  433.                   lines in Files.bbs that are started with a space or "-" will
  434.                   not be listed in the all files list. If this option is not
  435.                   specified, all remarks will be included.
  436.  
  437. /T                Do not add file area title in all files list. By doing this,
  438.                   FLPRO will not place the file area name at the top of each
  439.                   directory's list in the all files list. Default, FLPRO WILL
  440.                   add titles.
  441.  
  442. /K[x]             Number of popular downloads to be included in Popular
  443.                   Downloads List. With this, you can tell FLPRO how many top
  444.                   files to be listed in top download list. x is the number.
  445.                   eq. /K30
  446.  
  447. /Q                Back up Files.Bbs before writing new information. Use this if
  448.                   you want to play safe in case data corruption occurs.
  449.  
  450.  
  451. * Upload/Download options * (for RA 1.10 and compatible logfile users only)
  452.  
  453. Actions:
  454.  
  455. /W|s              Read RA log and update download counters in files.bbs By
  456.                   using /Ws, all the unlisted files that are downloaded will be
  457.                   skipped. Or else, FLPRO will append a new line with the file
  458.                   in your files.bbs. s option is optional. When the counter
  459.                   reachs 100, it will be reset to 1.
  460.  
  461. /U|s|@listform#@  Read RA log and add uploaders' name in Files.Bbs By adding
  462.                   `s' (eq. /Ws), all the unlisted uploads will (usually private
  463.                   uploads) will be skipped. Or else, FLPRO Will append a new
  464.                   line with the filename. s option is optional. With
  465.                   @listformat#@ option, you can change the default layout of
  466.                   uploaders name in Files.Bbs. The format should be started
  467.                   with a @ and ended with it too.
  468.  
  469.                   #    in the line indicates the location of the uploader name.
  470.                   ^    will be replaced by a CR+LF (ASC13+ASC10)
  471.                   $    replaced by 5 spaces.
  472.                   /v/  v is a numerical value. /v/ will be replaced with an
  473.                        ascii character v. useful to display characters that
  474.                        cannot be used in batch file like |<> etc.
  475.  
  476.                   eq. /Us@(Uploaded by: #)@ < -- skip unlisted files
  477.                       /U@(Uploaded by: #)@  < -- add unlisted files
  478.                       /U@/v/#/v/@           < -- ASC1 followed by the uploader
  479.                                                  name and then another ASC1
  480.                       /U                    < -- add unlisted files, default
  481.                                                  format
  482.                       /U@^; #@              <-- display uploaders name in 2nd
  483.                                                 line.
  484.  
  485.  
  486. example -
  487.  
  488. BOLO1000.ZIP [ 0] Silly lunatic simulator (Uploaded by: Tony Norton)
  489.  
  490. default -
  491.  
  492. BOLO1000.ZIP [ 0] Silly lunatic simulator; Tony Norton
  493.  
  494. Options:
  495.  
  496. /J                Join first and last names. With this, uploaders' names will
  497.                   be joined. example: Tony Wong becomes Tony-Wong and Lim Eng
  498.                   Kiat becomes Lim-Eng-Kiat. This is useful so that RA will not
  499.                   seperate the name when wrapping long lines. The whole name
  500.                   will be wrapped to the next line.
  501.  
  502. /M[path]          This option is REQUIRED or else FLPRO will not run with /U
  503.                   action. [path] is your upload directory where all the files
  504.                   received from users are located at.
  505.                   eq. /MC:\FILES\UPLOADS
  506.  
  507. /G[filespec]      RA's log filename. Default is RA.LOG but if you are using
  508.                   another name, you'll be needed to use this option. If
  509.                   the logfile is not found in current directory, FLPRO will
  510.                   search for RA= environment for Ra's directory. Pathname and
  511.                   directory name may also be used in [filespec]
  512.                   eq. /GC:\RA\LINE2\SYSTEM.LOG
  513.                       /GBBS.LOG
  514.  
  515. /I                Use uploader's initials instead of full name. example: Lai
  516.                   Zit Seng will become L.Z.S.
  517.  
  518. /Y                Read "compact" style RA logfile (also called frontdoor log in
  519.                   RA 1.00). Default setting is "expanded" (opus/verbose). You
  520.                   must specify this if you are NOT using expanded log or else
  521.                   you WILL encouter problems.
  522.  
  523. P.S. All logfiles after processed will be appened to *02.LOG file. The
  524.      processed file will be deleted. That means if the original logfile is
  525.      RA.LOG then it will be renamed to RA02.LOG and FILENAME.LOG will be
  526.      renamed to FILENA02.LOG
  527.  
  528.  
  529. Defaults:
  530.  
  531. Allfiles           : ALLFILES.LST
  532. Header control     : none
  533. Statistics file    : FILESTAT.ASC
  534. Popular file list  : POPDL.ASC
  535. RA logfile         : RA.LOG
  536. New logfile        : RA02.LOG
  537. Adopt control file : none
  538. Log style          : Expanded/Opus
  539. U/l name format    : full name
  540. u/l name list form : "; uploader-name"
  541. directory          : current directory (auto search for RA environment)
  542.  
  543. o skips all unlisted files
  544. o processor all areas
  545. o run for RA 1.10 system
  546. o convert files.ra to Flsearch.Ctl
  547. o don't back up files.bbs
  548. o 50 popular downloads
  549. o dont add download counters
  550. o all remarks in allfiles list
  551.  
  552. PS :
  553.  
  554. FLPRO.LOG will be created when an error is occured during process which
  555. contains a brief description of the error.
  556.  
  557. For Fido 12 users, you MUST run FLPRO with AREAS.INI in the same directory
  558. No wildcards (*,? etc.) are allowed in any file specifications. including
  559. the adopt file control.
  560.  
  561. Samples are supplied, please read them for reference if you are confused.
  562.  
  563. Examples:
  564.  
  565. flpro /fadopt.ctl /a600-210.lst /h /c /ptopdl.asc /sstatist.asc /k10 /$4,2
  566. o produce allfiles list w/ filename 600-210.lst
  567. o add headers to files.bbs
  568. o process all directories except areas 4 and 2
  569. o generate top 10 downloads file - topdl.asc
  570. o generate statistics file - statist.asc
  571. o adopt unlisted files using control file adopt.ctl
  572. o arrange download counters
  573.  
  574.  
  575. flpro /w /us@^$$$$$$\124\Uploaded by #\124\@ /j /md:\bbs\uploads\
  576. o open RA.LOG as logfile, expanded log style
  577. o read log and update download counters
  578. o upload path is d:\bbs\uploads\
  579. o join uploaders first and last names
  580. o read log and update uploaders names
  581. o skip unlisted uploaders
  582. o uploaders name on another line. \124\ is ASCII #124 (|)
  583.  
  584. eq: TEST_100.ZIP   34500 10-10-91 *[ 0] Test Program
  585.                                    |Uploaded by Lai-Zit-Seng|
  586.  
  587. flpro /anewfiles.lst /n5
  588. o process all directories
  589. o produce all files list - newfiles.lst
  590. o only list new files in 5 days
  591.  
  592. flpro +fido /b2 /e5 /r /h
  593. o begins at file area #2, ends at #5
  594. o running for Fido v12
  595. o sort files.bbs in alphabetical order
  596. o add headers to files.bbs
  597.  
  598. flpro +fido /a /s
  599. o running for Fido v12
  600. o process all directories
  601. o generate all files list with default filename - allfiles.lst
  602. o generate statistics file with default filename - filestat.asc
  603.  
  604.  
  605.                            Simple AREAS.INI Structure
  606.  
  607. Not all of Fido12's AREAS.INI file is needed by FileList Pro to run. FLPRO will
  608. only check for 2 keywords in this file : "FileArea=" and "D="
  609.  
  610. Each line of this line consist of data for _ONE_ file area. Example:
  611.  
  612. Filearea="C:\UPLOAD" D="Upload Directory"
  613. Filearea="C:\COMM" D="Data Communications"
  614.  
  615. Where "filearea=" contains the file path and "D=" contains the file area
  616. name/description.
  617.  
  618. AREAS.INI is simply a plain ASCII text file so any BBS software users will be
  619. able to create one. Remember to use +FIDO option while running FLPRO to tell
  620. the program to read the AREAS.INI file.
  621.  
  622.  
  623.                               Header Control File
  624.  
  625. The header control file allows you to design your own headers! Several keywords
  626. can be used to display different information of the directory.
  627.  
  628.             Key Description                          Characters
  629.             %T  Current Time                            5
  630.             %D  Current Date                            9
  631.             %N  Area Number (from left)                 3
  632.             %U  Area Number (from right)                3
  633.             %A  Area Name (from left)                   30
  634.             %R  Area Name (from right)                  30
  635.             %F  Number of on-line files (from left)     4
  636.             %I  Number of on-line files (from right)    4
  637.             %S  Directory Size / KiloBytes (from left)  5
  638.             %Z  Directory Size / KiloBytes (from right) 5
  639.             %O  Number of off-line files (from left)    4
  640.             %L  Number of off-line files (from right)   4
  641.             %%  Display percentage sign "%"             1
  642.  
  643. Example:
  644.  
  645. (----5----10---5----20---5---30)      <-- Number of characters
  646.  Upload Directory                     <-- Area Name from left
  647.                Upload Directory       <-- Area Name from right
  648.  
  649. Note that FLPRO will leave a line of 75 x ASCII# 205 at the end of all headers
  650. to signify the end of the header.
  651.  
  652. A sample control file is provided for your reference.
  653.  
  654.                             All files list structure
  655.  
  656. If you didn't use option /T to disable directory info in allfiles list, the
  657. generated list should look something like this:
  658.  
  659. ■ Area # 1  ■ User Recent Uploads
  660. ───────────────────────────────────────────────────────────────────────────────
  661.  
  662. CHEEKEN.ARJ  46310     8 Mar 92 *[ 7] Story of a Chicken's life
  663. RA-PATCH.ZIP 2542      2 Mar 92 *[35] Utility to "fix" RA 1.11
  664. .
  665. .
  666. ───────────────────────────────────────────────────────────────────────────────
  667. Total of 24 online files and 1 offline files.
  668. 12 new files are listed.
  669. ───────────────────────────────────────────────────────────────────────────────
  670.  
  671.  
  672.                                  Registeration
  673.  
  674. FLPRO is released under the Shareware concept. Re-distribution is encouraged
  675. provided that no extra fee are charged. But the usage of this program is not
  676. free. It is not a freeware nor public domain. Please send a minimum amount of
  677. S$20 (foreign countries US$15, phone call charges included) to the address
  678. below enclosed with the form. A registeration key will be sent to you after
  679. registeration.
  680.  
  681. A registered copy will replace "Evaluation" message in allfiles list etc. with
  682. your bbs name. The delay in runs will also be removed. A "+" will be added at
  683. the end of the version number eq. 4.41+
  684.  
  685.  
  686.  
  687.                                Registeration Form
  688.  
  689. Sysop real full name (max 30 char) : ________________________________________
  690.  
  691. BBS Name (max 40 char) : ____________________________________________________
  692.  
  693. Operation hours : ___________________________________________________________
  694.  
  695. Baud rate(s) and protocols : ________________________________________________
  696.  
  697. Full Mailing address : ______________________________________________________
  698.  
  699. _____________________________________________________________________________
  700.  
  701. _____________________________________________________________________________
  702.  
  703. Voice contact number(s) : ___________________________________________________
  704.  
  705. BBS Datel number(s) : _______________________________________________________
  706.  
  707. FidoNet Address (if any) : __________________________________________________
  708.  
  709. Other Networks with netmail addresses : _____________________________________
  710.  
  711. _____________________________________________________________________________
  712.  
  713. _____________________________________________________________________________
  714.  
  715. Paying S$40/US$25 extra for future upgrades delivery (YES/NO)? ______________
  716.  
  717. Amount enclosed    : S$ __________________ or US$ ___________________________
  718.  
  719. Suggestions (if any) : ______________________________________________________
  720.  
  721. _____________________________________________________________________________
  722.  
  723. _____________________________________________________________________________
  724.  
  725.  
  726.  
  727. Registeration, suggestions etc. send to:
  728.  
  729.                 Ong Geok Meng
  730.                 15 Tai Yuan Heights
  731.                 Singapore 1955
  732.                 Republic of Singapore
  733.  
  734. Electronic Mailing Network addresses:
  735.  
  736.   Node 6:600/210@fidonet.org
  737.   AKA  88:101/1@dmlinks.asia
  738.   AKA  88:88/1@dmlinks.Asia
  739.   AKA  60:8500/14@worldnet
  740.   AKA  74:8000/304@doornet
  741.   AKA  46:9100/106@ChatNet.Oceana
  742.  
  743.   CM,XA
  744.  
  745. Support and Test Sites :
  746.  
  747.    SINGAPORE
  748.    ---------
  749.    Depeche Megalopolis BBS                      Magic 32 Information System
  750.    +65 283-4010 at 1200/2400/9600 BPS           +65 242-1133 at 1200/2400 BPS
  751.    CCITT v22 v22bis v23 v32 v42bis/v42; H96     CCITT v22 v22bis
  752.    Network address as above.                    88:101/20.0@dmlinks.asia
  753.    24 hours operation                           Weekdays 2330-1200 hours
  754.                                                 Weekends 2330-1500 hours
  755.  
  756.    Notice BBS
  757.    +65 382-1200 at 1200/2400/9600/14400 BPS
  758.    CCITT v22 v22bis v23 v32/v32bis v42/v42bis
  759.    6:600/306.0@fidonet.org; CM
  760.    88:101/16.0@dmlinks.Asia
  761.    24 hours operation
  762.  
  763.    MALAYSIA
  764.    --------
  765.    Info-Net BBS (Petaling Jaya, Kuala Lumpur)
  766.    +60 3 334-1771 at 1200/2400/9600/14400 BPS
  767.    CCITT v22 v22bis v32 v42bis/v42 ; HST
  768.    6:609/67.0 aka 6:609/0@fidonet.org ; CM
  769.    88:103/1.0 aka 88:103/0@dmlinks.asia
  770.    24 hours operation
  771.  
  772.  
  773.                                  Miscellaneous
  774.  
  775. Trademarks and Copyrights are reserved :-
  776.  
  777. MS-DOS by Microsoft Corp
  778. RA/RemoteAccess by Andrew Milner and Continential Software
  779. Fido/FidoNet by Tom Jennings
  780. QBBS/QuickBBS by Adam Hudson
  781. Frontdoor by Joaquirm H. and Advanced Engineering sarl.
  782. DesQView/Qemm by QuarterDeck Systems
  783. IBM/PC/8088/8086/80286/80386/80486 by International Business Machines
  784.  
  785. BLESS the people who had helped in saving lives of animals and human beings
  786. and the environment.
  787.  
  788. BLAST the killers who invent killing machines, and use them.
  789.  
  790. Thanks to my beta testers, programming manuals, supporting BBS's, supporters,
  791. and Singapore products promoters; also parents who had financially supported
  792. me.
  793.  
  794. Tony Wong, Lim Eng Kiat and Lai Zit Seng appeared courtesy of themselves.
  795.  
  796. FLPRO - more Singapore products from NSoft.
  797.  
  798. <*** End of Documentations ***>
  799.